home *** CD-ROM | disk | FTP | other *** search
/ User's Choice Windows CD / User's Choice Windows CD (CMS Software)(1993).iso / misc1 / iq10.zip / README.TXT < prev   
Text File  |  1993-05-31  |  11KB  |  251 lines
  1. Introduction
  2. ------------
  3.  
  4. Import Quotes (IQ) is a Windows program that convert and import quotes into
  5. Quicken.  Quotes retrieved from online services such as CompuServe and 
  6. Fidelity Online Exchange can be converted to a Quicken import file, and
  7. imported directly into Quicken.
  8.  
  9. To convert quotes, you simply create a file containing the quotes. Next you
  10. tell IQ where the file is, and how to parse it.  Finally,  you start the
  11. conversion, and IQ  creates an import file with the converted quotes.
  12. The method for saving quotes from online services will vary.  If you use
  13. WINCIM, you save quotes after they are displayed by selecting "save as" from
  14. the file menu, and entering a filename  (Tip: setup the recorder with a 
  15. hot-key to automate saving quotes to a file).
  16.  
  17. The IQ program import quotes into Quicken by mimicing Quicken keystrokes to
  18. import quotes from a file.  When an import is started, IQ scans the desktop
  19. for Quicken. If Quicken is found, it is activated and sent keystrokes to
  20. import the quotes.  IQ can also be configured to start Quicken if is not 
  21. on the desktop.  However, this is not recommended if you use password 
  22. protection on your Quicken account.  If you do use a password, start 
  23. Quicken, enter your password, and then tell IQ to convert and import the
  24. quotes.  Refer to your Quicken manual for the format of the import quote
  25. file.
  26.  
  27. It is highly recommended that before importing quotes into Quicken, read
  28. the Quicken manual to setup the accounts, along with security symbols.
  29. Also before importing, perform a conversion only and then check the output 
  30. file from the conversion ("filename".iq) to make sure that quotes are being
  31. converted properly.  If you are using an unregistered version, open the 
  32. converted file in an editor such as notepad for viewing.  If you're using a
  33. registered version, turn on logging before the conversion, and then view the
  34. log after the conversion is complete.  If the conversion does not work
  35. properly, adjust the parser parameters and try again.  Once you are
  36. satisfied that the conversion is working properly, start an import.
  37.  
  38.  
  39. Features
  40. --------
  41.  
  42. 1) Convert and/or import quotes into Quicken with one keystroke.
  43. 2) Configurable parser.
  44. 3) Date selection for imported quotes (With this feature, you can enter
  45.    quotes from a previous date).
  46. 3) *Ability to create, store, and retrieve different parser sets.
  47.     (Nice feature if you get quotes from multiple sources and you need
  48.      to keep different parsing parameters for each quote source)
  49. 4) Set Editor for creating parser sets.
  50. 5) *Conversion and import log.
  51.  
  52.  
  53.  
  54.  
  55. File Contents of iq.zip 
  56. -----------------------
  57.  
  58.           readme.txt  - this file
  59.           iq.exe      - import quote executable file
  60.           iqhooks.dll - dynamic link library used by iq
  61.           iq.ini      - initilization file for iq
  62.           bwcc.dll    - borland custom dialog dynamic link library
  63.           order.txt   - registration form
  64.  
  65.  
  66. Installation
  67. ------------
  68.  
  69. Create a \iq directory or use the current directory that the files
  70. were unziped into.  The files iq.exe, iqhooks.dll, iq.ini, and order.txt
  71. MUST be in the same directory.  The bwcc.dll file should be moved to the
  72. \windows\system directory if one is not already present, or is older than
  73. this version.  Next, using program manager, create a new item in your
  74. desired program group and enter the file name along with path for IQ
  75. (iq\iq.exe) in the command line entry.
  76.  
  77.  
  78. Program Operation
  79. -----------------
  80.  
  81.  
  82. Main Control Dialog
  83. -------------------
  84.  
  85. Start     - Press the start pushbutton to convert and/or import
  86.             quotes.  Note: setup options after installation before
  87.             entering start.
  88.  
  89. Options   - Press the options pushbutton to open the options dialog box.
  90.  
  91. *View Log - Press the view log pushbutton to view the conversion/import
  92.             log 
  93.  
  94. About     - Press the about pushbutton to get info about the program and to
  95.             register.
  96.  
  97.  
  98.  
  99.  
  100. Options Dialog
  101. --------------
  102.  
  103. 'Program Control' is where you tell IQ what to do when the start button is
  104. pressed.  IQ can be instructed to convert, import, or convert
  105. and import when the start pushbutton is pressed.
  106.  
  107. When the *'log' flag is set, IQ logs all conversions and imports to the log
  108. file.  The log file name is "iq.log", and it is created in the same
  109. directory that the "iq.exe" file resides in.
  110.  
  111. The 'Quote Input File' is the path and filename that contains the
  112. quotes to be converted.  This is the file that is saved from your online
  113. service or other source.  When performing a conversion, IQ creates a
  114. new file with the same name as your input file with a '.iq' extension.
  115. This new file contains the converted quotes and is created in the same
  116. directory that the Quote Input File resides in.  If no path is specified,
  117. the Quote Input File is assumed to be in the current working directory.
  118.  
  119.  
  120. The 'Quicken Command' is the command line to start Quicken.  If you set
  121. this up, IQ will execute this command before importing if Quicken is not
  122. running on the desktop.  You should leave this field blank if you use 
  123. password protection on your Quicken account.
  124.  
  125. The 'Conversion Parser' section contains the parameters that tell IQ
  126. how to parse the 'Quote Input File'.  A quote consist of three components,
  127. a symbol, price, and date.  The parser parameters tell IQ which columns
  128. in the 'Quote Input File' contains these components and what is the
  129. starting row or line of the first quote.
  130.  
  131.    Most quotes that are retrieved contain some number of header lines before 
  132.    the first quote.  Enter a number between 0 and 99 in the 'Header Lines'
  133.    field to indicate the number of header lines before the first quote.
  134.  
  135.    Enter a column number between 1 and 239 for the 'Symbol Column'.
  136.  
  137.    Enter a column number between 1 and 239 for the 'Price Column'.
  138.  
  139.    Enter the source of the date from the list.  The date can be taken from
  140.    either the 'Quote Input File', from the field below, or the current date.
  141.    If the current date is selected, the date will be the date that the
  142.    quotes are converted.  If the date source is from the field, enter the
  143.    date (mm/dd/yy) in the date field.  If the date source is from the file,
  144.    enter a column number between 1 and 239 for the 'Date Column'.
  145.  
  146.  
  147. The Create, Load, and Delete pushbuttons are used to create/save, load
  148. and delete parser sets.  One parser set consist of:
  149.  
  150.              o User supplied tag (up to 8 chars.)
  151.              o Number of header lines
  152.              o Symbol Column
  153.              o Price Column
  154.              o Date Column
  155.              o Date Source
  156.  
  157. Create - Press the create pushbutton to start the set editor to create and
  158.          save a parser set.
  159.  
  160. Load   - Press the load pushbutton to load a parser set into the option
  161.          menu conversion parser fields.
  162.  
  163. Delete - Press the delete pushbutton to delete a parser set.
  164.  
  165. There are two predefined parser sets available with the program:
  166.  
  167.              Number of Header      Symbol     Price     Date     Date
  168.  TAG         Lines                 Column     Column    Column   Source
  169. ---------    ------------------    ------     ------    ------   ------
  170. WINCIM              2                1          36       56      Current
  171. FOX                 2                18         46       145     From File
  172.  
  173.  
  174. If you use WINCIM to get quotes, use the WINCIM parser set to parse a quote
  175. file saved from WINCIM.  If you create an export file from Fidelity Online
  176. Exchange, use the FOX parser set to parse this file.  Use the set editor to
  177. create additional parser sets.
  178.  
  179. OK     - Press the OK pushbutton to save the options and return to the
  180.          main control dialog.  
  181.  
  182. Cancel - Press the cancel pushbutton to discard any changes made while
  183.          in the option menu, and return to the main control dialog.
  184.  
  185.  
  186. Set Editor - Creating a parser set
  187. ----------------------------------
  188.  
  189. Use the set editor to create and save a parser set.  Before starting the
  190. editor, enter the 'Quote Input file'.  This is the file that will be loaded
  191. into the editor.  The set editor initializes with the parser parameters
  192. from the option menu.  Make sure that the marker option is on to see the
  193. current parser settings applied to the file.
  194.  
  195. To create a parser set, position the cursor to the symbol column for the
  196. first quote in the file and press the left-mouse button.  A cursor position
  197. dialog box will appear.  Check the 'first quote row' box and the 'symbol 
  198. column' box.  If the marker option is on, the symbol column should appear in
  199. reverse video starting at the first quote row, and the letter 'S' will be
  200. displayed on the first row.  To identify the price column, position the
  201. cursor to the price column, press the left-mouse button, and check the 
  202. 'price column' box (column reverse video with letter 'P' in the first row).
  203. To identify the date column, position the cursor to the date column, press
  204. the left-mouse button, and check the 'date column' box (column reverse video
  205. with the letter 'D' in first row).  Note, the first quote can be identified
  206. at anytime or while obtaining the symbol, price, or date column.
  207.  
  208.    File Menu
  209.  
  210.        Save - Save the editor parser settings, i.e. the number of header
  211.               lines, symbol column, price column, date column, and date
  212.               source.  Enter a tag to identify the parser set.  Once the
  213.               set has been created it can be loaded into the option menu
  214.               conversion parser fields at anytime by pressing the load
  215.               pushbutton on the option menu.
  216.   
  217.        Quit - Discard the editor parser settings and return to the option
  218.               menu.
  219.  
  220.        Exit - Move the editor parser settings, i.e. the number of header
  221.               lines, symbol column, price column, date column, and date
  222.               source to the option menu conversion parser fields and return
  223.               to the option menu.
  224.  
  225.    Options Menu
  226.  
  227.        Markers - Select Markers to turn the settings markers on or off.
  228.  
  229.        Date    - Select the date source for the quotes.
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  Notes on Parsing
  236. -----------------
  237.  
  238.   Right-Adusted data & White Spaces
  239.   ---------------------------------
  240.  
  241.       The parser is capable of skipping over white spaces preceding
  242.       a column entry.  This gives the parser the capability to parse
  243.       right-adjusted data in columns.  When parsing right-adjusted
  244.       data columns, the best place to set the cursor is the column
  245.       immediately following the previous data column, which is usually
  246.       a blank.
  247.       
  248.  
  249.  
  250. * Only available in the licensed version.
  251.